home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / programs / nd300.zip / NODEDOOR.DOC < prev    next >
Text File  |  1993-01-01  |  22KB  |  602 lines
  1.  
  2.  
  3.  
  4.  
  5.            ////    /// ///////  //////   ///////
  6.          // //  //   //   //  //   //  //
  7.        //  // //   //   //  //   //  /////
  8.      //   ///    ///////  //////   //
  9.   ///     /                      ///////////////
  10.                           /////////  //////// //////// ////////
  11.                            //    // //    // //    // //    //
  12.                           //    // //    // //    // ///////
  13.                          //    // //    // //    // //  //
  14.                         //    // //    // //    // //   //
  15.                      /////////  //////// //////// //   //////////////
  16.  
  17.            NODE-DOOR 3.00  Copyright (C)  1992, Don Laverdure
  18.  
  19.  
  20.  
  21. Compatible with: RA SBBS QBBS MAXIMUS TAG PCBoard Wildcat Spitfire and more
  22.  
  23.           FIDO and FIDONET Nodelists are Copyright Tom Jennings
  24.  
  25.               UNREGISTERED VERSIONS ARE DEMONSTRATIONS ONLY
  26.  
  27.           If not registered within 30 days, Please Discontinue use.
  28.  
  29.           !!!  NODE-DOOR will stop functioning if unregistered  !!!
  30.                   Avoid this by registering within 30 days
  31.                    NODE-DOOR is Shareware, not FreeWare
  32.  
  33.  
  34.  * May require DORINFO#.DEF for registered versions
  35.  
  36.   NODE-DOOR is a simple to install node list searching door that will
  37.  allow users maximum flex ability when looking up addresses and other
  38.  information located in the RAW nodelist.  Because it uses the RAW
  39.  nodelist,  There is little overhead associated with built-in or
  40.  other add-on nodelist look-up utilities.  You do not need another
  41.  compiled nodelist to run NODE-DOOR.  This also allows NODE-DOOR to
  42.  run on almost any BBS software package.
  43.  
  44.   Up to 15 Nodelists can be configured through the use of a Config file
  45.   explained later.
  46.  
  47.   To Install simply copy the file NODEDOOR.EXE into a directory. Then
  48.  using any style of door exit, use the following command line.
  49.  
  50.  * CONSULT YOUR BBS SOFTWARE MANUAL FOR THE PROPER INSTALLATION OF DOOR
  51.    PROGRAMS.
  52.  
  53.  * LOCKED BAUD RATES for High Speed Modems.   You must properly lock
  54.  your Baud Rate.  Here are two examples of a properly locked Fossil.
  55.  
  56.     X00 B,1,38400 T=1024 R=2048 E
  57.     BNU.COM /O /L:1=38400 /F+ /Z0 /M- /T:1024 /R:2048
  58.  
  59.   See Fossil Docs for an explination of commands
  60.  
  61.  
  62.  * If running NODE-DOOR form within another directory, set the
  63.    Environment variable NODEDOOR in your Autoexec.bat
  64.  
  65.    IE:
  66.  
  67.    SET NODEDOOR=C:\NODEDOOR\
  68.  
  69.  
  70.  
  71.   NODEDOOR <node>
  72.   node  this is the node for multi-node boards.  If you are running this
  73.         door on node 2 then this would be set to 2 so that the door will
  74.         look for DORINFO2.DEF rather then DORINFO1.DEF.
  75.         Under RA and some other systems, This would be set to 1 for all
  76.         nodes as they all use the dorinfo1.def
  77.                                          ^
  78.  
  79.  
  80.  ADDRESS            BBS               City           Phone         BAUD RATE
  81.  
  82.  1:1/0      │ North America       │Harrisburg P│1-717-657-7097  │9600HST
  83.  1:1/1      │ FidoNews            │FidoNews Edi│1-415-863-2739  │9600HST
  84.  1:1/2      │ Europe Gate         │Portland OR │1-503-297-9145  │2400
  85.  1:1/3      │ Oceania Gate        │Portland OR │1-503-297-9145  │2400
  86.  
  87.    SAMPLE ZOOM MODE:
  88.  
  89.  BBS Listing,    FULL VIEW MODE,
  90.  1:1/0       North America            Harrisburg PA
  91.              George Peace             1-717-657-7097     9600 HST
  92.  1:1/1       FidoNews                 FidoNews Editor      XA CM
  93.              Tom Jennings             1-415-863-2739     9600 HST
  94.  1:1/2 HUB   Europe Gate              Portland OR          XX UUCP
  95.              R Bush                   1-503-297-9145     2400
  96.  1:1/3       Oceania Gate             Portland OR          XA
  97.              R Bush                   1-503-297-9145     2400
  98.  1:1/4       Latin America Gate       Portland OR          CM XA
  99.  
  100.  
  101.   NOTE:  ZOOM MODE and FAST MODE search at the same speed,  ZOOM MODE
  102.          takes longer to display by nature of it's increased info.
  103.  
  104.                          SAMPLE MENU OPTIONS
  105.  
  106.  
  107.                 [S] Search Nodelist (Create a list of BBSs)
  108.                 [D] Download BBS List (Create one first)
  109.                 [M] Return to MAIN MENU
  110.  
  111.             Select please > _
  112.  
  113.  
  114.            S option can be a shell or full exit with errorlevel
  115.            D option - Auto Download "NODEDOOR.LS1" for node 1
  116.                     - Nodedoor creates this file in it's current
  117.                     - directory.  You could get fancy and use the
  118.                     - batch file to compress it.
  119.                     - NOTE: .LS1 for node 1   .LS2 for node2 etc..
  120.            M option is self explanitory.
  121.  
  122.        See your BBS documents on how to create a Menu like this.
  123.  
  124. SAMPLE BBS LIST  "NODEDOOR.LS1"
  125.  
  126. ********************************************************************************
  127. * NODE - DOOR   3.00  BBS LIST GENERATOR  (C) Copyright 1992 Don Laverdure     *
  128. ********************************************************************************
  129.  This BBS list is brought to you by D R L  B B S  Kingston, Ont. Canada
  130.                            DATE:  09-04-92
  131.  
  132.            Searching for: 1:0/
  133.  
  134. 1:0/1            FidoNews                    1-415-863-2739  9600 HST          
  135.                  Tom Jennings                FidoNews Editor   CM              
  136. 1:0/2            Europe Gate                 1-503-297-9145  2400              
  137.                  R Bush                      Portland OR       XA CM           
  138. 1:0/3            Oceania Gate                1-503-297-9145  2400              
  139.                  R Bush                      Portland OR       XA CM           
  140. 1:0/4            Latin America Gate          1-503-297-9145  2400              
  141.                  R Bush                      Portland OR       XA CM           
  142. ========================== chopped here ============================
  143.  
  144.  
  145.    NOTE:  This file is deleted and recreated every time NODEDOOR is run
  146.    up.
  147.  
  148.  
  149.  
  150.                    SAMPLE BATCH FILE: NODEDOOR.BAT
  151.  
  152.                        @ECHO OFF
  153.                        CLS
  154.                        CD\DOORS
  155.                        NODEDOOR 1
  156.                        arj f m BBSLIST.ARJ NODEDOOR.LS1
  157.  
  158.  
  159.   This is a sample of a batch file as used on a MAXIMUS system. Please
  160.   check you BBS software for instructions on installing door programs.
  161.  
  162.   WARNING!  This door requires a FOSSIL driver such as BNU or X00.
  163.  
  164.  
  165.  CONFIGURATION FILE:
  166.  
  167.   The Configuration now serves two purposes, 1. It contains the node
  168.   information and 2. contains the nodelist information.
  169.  
  170.   There are 6 KEYWORDS
  171.  
  172.  NODELISTPATH F:\NODELIST\   The path to your Nodelist
  173.  EXITFILEPATH C:\WORK\       The path where NODE-DOOR can find
  174.                              DORINFO#.DEF
  175.  DOORKEY 199046632912        Your Key Code if registered
  176.  INITMODE ZOOM               The Mode ZOOM or NORMAL
  177.  MAKEFILE YES                Create NODEDOOR.LS?  YES or NO
  178.  NODELISTINGS                Signals Beginning of nodelist descriptions
  179.  
  180.  ALL paths MUST be followed by a backslash "\"
  181.  NODELISTINGS *MUST* be at the end of the keyword statements
  182.  ALL KEYWORDS MUST BE IN ALL CAPS
  183.  
  184.   Example:
  185.  
  186.           NODELISTPATH F:\NODELIST\
  187.           EXITFILEPATH C:\WORK\
  188.           DOORKEY 34131452435630
  189.           INITMODE ZOOM
  190.           MAKEFILE YES
  191.           NODELISTINGS
  192.           NODELIST
  193.           FidoNet Nodelist over 20,000 entries.
  194.           QUINLIST
  195.           Quinte Network Listing (Quinte Region)
  196.  
  197.  
  198. To convert from 2.10 and earlier,  Simply move the parameters to the
  199. config file like this....
  200.  
  201.                    NODEDOOR C:\WORK F:\NODELIST 2323132 1 ZOOM
  202.                             /        /           /        /
  203. EXITFILEPATH C:\WORK\ <----+       /           /        /
  204. NODELISTPATH F:\NODELIST\ <------+           /        /
  205. DOORKEY 2323132  <--------------------------+       /
  206. INITMODE ZOOM  <-----------------------------------+
  207.  
  208. ( Note the added backslashs on path names )
  209.  
  210. * NOTE  Command line parameters override config file settings.
  211.  
  212. ADDED FEATURES:
  213.  
  214.  MAKEFILE YES / NO   If you do not wish NODEDOOR to create the
  215.                      downloadable BBS LIST file specify NO.
  216.                      If you do, Specify YES
  217.  
  218.  NODELISTINGS       Keyword to signify the start of the nodelist name
  219.                     and description section explained below
  220.  
  221.  
  222. Now use  NODEDOOR.EXE 1  for node 1,  NODEDOOR.EXE 2 for node 2...
  223. etc...  This will cause nodedoor to use DORINFO1.DEF or DORINFO2.DEF
  224. depending on what the number is following NODEDOOR.EXE.  This will also
  225. cause nodedoor to create NODEDOOR.LS1 or NODEDOOR.LS2 respectively.
  226.  
  227.  
  228.  * MULTI-NODE  OPTIONS
  229.  
  230.  
  231.   The command line parameters are as follows:
  232.  
  233.   NODEDOOR.EXE <node> <path> <RA>
  234.  
  235.  <node> is the node number from 1 - 9, this will cause NODE-DOOR to look
  236.         for DORINFO#.DEF and create NODEDOOR.LS# where # is 1-9.
  237.         *IF* you include RA as the third parameter, NODE-DOOR will only
  238.         look for DORINFO1.DEF
  239.  
  240.  <path> This option overrides the path to the info files used in the
  241.         config.  For example, if each node uses a separate path for it's
  242.         info files, each node may locate the proper path through this
  243.         parameter.
  244.  
  245.   <RA>  Placing the keyword RA in the third position forces NODE-DOOR to
  246.         only use DORINFO1.DEF regardless of the node number indicated in
  247.         the first parameter.  This is for Remote Access compatibility.
  248.  
  249.    An example of it's usage might be:
  250.  
  251.     NODEDOOR %1 C:\RANODE%1 RA
  252.  
  253.     The %1 is a macro that will be changed to the proper node number.
  254.  
  255.     C:\RANODE%1  will be interpreted as C:\RANODE1 for node 1, C:\RANODE2
  256.     for node 2 and so on.  Please consult you BBS manual and DOS for
  257.     more information on passing values to a command line.
  258.  
  259.  
  260.  
  261.     Through the use of a CONFIGURATION FILE, NODE-DOOR can access up to 15
  262.   different nodelists.  This is to allow Sysops who support other networks the
  263.   ability to let their users search those lists.  One that comes to mind is
  264.   IMEXNET.  As long as the nodelist is FidoNet compatible, Node-Door will
  265.   function with it.  The Configuration file is a standard Text File named
  266.   NODEDOOR.CFG.  The file must contain 2 lines for each nodelist used.  All
  267.   nodelists must be in the Nodelist Path used in the command line.  The first
  268.   line is the name less extension of the nodelist, Nodedoor automatically finds
  269.   the most recent list and extension, and the second line is the description
  270.   you would like placed in the menu for that nodelist.
  271.  
  272.   NOTE:  NODE-DOOR begins looking for the nodelist starting at today's
  273.          Julian date plus 5 days.  If todays Julian date is 195,  Then
  274.          NODE-DOOR will begin looking for NODELIST.200 and work back to
  275.          get the most recent nodelist available.   Some nets number
  276.          their nodelists differently,  if this is the case then
  277.          NODE-DOOR will not be able to locate that list.
  278.  
  279.  
  280.          IE: CITYLINK.666 will be unavailable to NODE-DOOR
  281.              If today's date is 195 Julian, and you have NODELIST.289
  282.              then it will not be available until DAY 284.
  283.  
  284.         It is important to maintain an up to date nodelist for this and
  285.         other obvious reasons.  Users like up to date info.
  286.  
  287.         Placing an asterix (*) in front of the description will cause
  288.         NODE-DOOR to override the Nodelist description in the nodelist
  289.         if available.
  290.  
  291.  
  292.   IE:
  293.  
  294.   NODELIST
  295.   FULL FidoNet Node List
  296.   IMEXLIST
  297.   FULL IMEXnet Node List
  298.   ADULT
  299.   * Adult Link Node List
  300.  
  301.  RESULT:
  302.  
  303. Nodelists available on The Pie in the Sky BBS
  304.  
  305.    0 - FULL FidoNet Node List
  306.    1 - FULL IMEXnet Node List
  307.    2 - Adult Link Node List
  308.    Z - Toggle ZOOM mode OFF
  309.    Q - Quit to BBS
  310.  
  311.  Select 0 - 2, Z or Q  >
  312.  
  313.  
  314.   ON-LINE HELP:
  315.  
  316.    The NODE-DOOR help screen is incorporated into the main screen.  By default
  317.  the built in help or explanation of commands screen will be displayed.  You can
  318.  override this and place your own help screen by creating an ANSI or ASCII file
  319.  called NODEDOOR.ASC or ANS.  These files can contain some of the usual user
  320.  codes.
  321.  
  322.     NOTE:  The screen should not position the cusor or clear the screen
  323.        see sample NODEDOOR.ANS NODEDOOR.ASC files.
  324.        FULL SCRREN HELP files and cursor positioning will cause
  325.        unpredictable results.  It is best to simply edit the
  326.        supplied files without changing their length.
  327.  
  328.   ^FA      User's full name
  329.   ^FB      User's location
  330.   ^FO      User's Security level
  331.   ^FW      User's First name only
  332.   ^FX      Ansi Setting
  333.   ^KO      Min left
  334.   ^KW      Node User is currently on
  335.  
  336.    ( not available on all systems )
  337.  
  338.   ( ^F = Control F or Char 006 ASCII )
  339.  
  340.  *  NOTE:  Do not exceed 10 lines or the screen will become
  341.         distorted.
  342.  
  343.   Enclosed is a sample NODEDOOR.ANS.  The ANSI draw utility must not use
  344.   screen clears or cursor position codes.  (I would just edit the
  345.   sample)
  346.  
  347.    The screen must maintain room for the Search String Prompt and Display.
  348.  
  349.  
  350.  
  351.   SYSOP KEYS:  arrow up   = increase user time
  352.                arrow down = decrease user time
  353.                alt H      = hang up
  354.                alt L      = Lock out
  355.                alt K      = turn off caller's keyboard
  356.                alt D      = drop to BBS
  357.                F1         = caller info display
  358.                F9         = Help bar
  359.  
  360.   USING NODEDOOR:
  361.  
  362.  
  363.     When selected, you will be asked to enter a search string. This is
  364.   what Node Door will use to compare against the nodelist. Do not use
  365.   the underscores IE: Don Laverdure *NOT* Don_Laverdure.
  366.  
  367.     You can search for any string you feel might be contained in the
  368.   nodelist. To find a list of the boards in Kingston Ontario, simply
  369.   enter a search string of "Kingston" or "Kingston on". Note that
  370.   "Kingston Ont" will not work as the entries in the nodelist all
  371.   contain "ON" and not "ONT" for Ontario.
  372.  
  373.     You can search for phone numbers like "1-613" to get all 613 area
  374.   code listings, or Bill to get a list of boards that have a SysOp by
  375.   the name of "Bill" or the word "Bill" in the BBS name, ect...
  376.   Capitalization is not important. Spelling is.
  377.  
  378.     Note that SysOp name do not appear but are valid for searching, Just
  379.   as are user flags like "UNEC", "HST" or "USDS". Do not include Quotes.
  380.  
  381.     Systems marked as Down will not appear in the listings as they
  382.   are un-dialable any way.
  383.  
  384.     To exit the door, simply enter a blank search string.  To abort the
  385.   search while in progress, press S.
  386.  
  387.   To set search NON-STOP on or off press C
  388.   To turn Visual display on or off press V
  389.  
  390.   While visual is OFF, a marker will appear on line 1 of the list are to
  391.   indicate the number of matches that were written to the BBS List file.
  392.  
  393.  
  394.     Well, That is all there is to it.  It is a fairly fast door when you
  395.   think about the size of the nodelist.  My callers and I find it very
  396.   helpful and I hope you do too.
  397.  
  398.     NODE-DOOR is self scanning to detect viruses.
  399.  
  400.  
  401.     It is through their testing and suggestions that we are able to
  402.     bring you this fine product at such a low cost.
  403.  
  404.  
  405.                  To REGISTER your copy of NODE-DOOR
  406.  
  407.                   DO NOT SEND "POSTAL" MONEY ORDERS
  408.                       Bank Money Orders are OK
  409.  
  410.  If sending to Author, Send $10.00 to:
  411.  
  412.   Don Laverdure                           FOREIGN FUNDS ACCEPTED
  413.   42 Leroy Grant Drive                    AT PROPER EXCHANGE RATES
  414.   Suite 407                               BASED ON US echange rates
  415.   Kingston, Ontario. CANADA               *NO Foreign Postal Money Orders*
  416.   K7K 6W8                                             ------
  417.  
  418.  Outside North America add $5.00 Handling Charges
  419.  
  420.  NO POSTAL MONEY ORDERS OUTSIDE CANADA
  421.     ======
  422.  
  423.  
  424.  Outside CANADA, $10.00 US FUNDS.          PLEASE CHECK THE POSTAL RATES
  425.                                               US - CANADA Rates vary
  426. --------------------------------------------------------------------------
  427.  
  428.   AUSTRALIAN registrations should be sent in $AUS to:
  429.  
  430.   DRL SUPPORT/REGISTRATION SITE
  431.   Denis Coleman
  432.   12 Neill Street
  433.   Berwick
  434.   Victoria
  435.   3806
  436.  
  437.   In Australia send $17 AUS payable to Denis Coleman.
  438. ---------------------------------------------------------------------------
  439.   UK registrations should be sent to: 2:257/35
  440.  
  441.   DRL Support/Registration Site UK
  442.   Jon Greaves
  443.   129 Boyton Rd
  444.   Ipswich
  445.   Suffolk
  446.   IP3 9NZ
  447.   UK
  448.  
  449.   In the UK, send 6 Pounds UK payable to Jon Greaves
  450. ---------------------------------------------------------------------------
  451.  
  452.  GERMANY registrations should be sent to:
  453.  
  454.  DRL SUPPORT/REGISTRATION SITE
  455.  Torsten Vollmer
  456.  Woerthstrasse 39
  457.  W-4500 Osnabrueck
  458.  Germany
  459.  
  460.  In Germany send 15 DM payable to Torsten Vollmer
  461. ---------------------------------------------------------------------------
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  IMPORTANT!
  470.  
  471.   You may Netmail 1:249/124 to see if there is a new site closer to you.
  472.  
  473.   Registration Fees may change without notice.  The rates in this
  474.   document are good until Dec 31 1992.  After that date you should
  475.   Netmail 1:249/124 or any of the Distribution Sites for a current price
  476.   listing.
  477.  
  478.  
  479. ==============================================================================
  480.      FOR    ||     KEY      ||   Date sent   ||  Time  || Site || PMT || CL ||
  481.  OFFICE USE ||              ||               ||        ||      ||     ||    ||
  482.     ONLY    ||              ||               ||        ||      ||     ||    ||
  483. ==============================================================================
  484.  
  485.  
  486.            N O D E - D O O R   3 . 0 0     R E G I S T R A T I O N
  487.  
  488.  Please register me as a supporter of door ware.  I have enclosed _______
  489.  including Handling charges if applicable, and would like my key sent via:
  490.  
  491.             Outside CANADA do not use *POSTAL* MONEY ORDERS.
  492.  
  493.  [ ] POST
  494.  [ ] FidoNet Crash Netmail.
  495.  
  496. if Via POST, my address is:
  497.  
  498.  ____________________________________________________
  499.  
  500.  ____________________________________________________
  501.  
  502.  ____________________________________________________
  503.  
  504.  ____________________________________________________
  505.  
  506.  INFORMATION:
  507.  
  508.  EXACT SysOp name as used in your BBS Config file:
  509.  
  510.  ___________________________________
  511.  
  512.  IF DORINFO1.DEF is different, Name used there is:
  513.  
  514.  ___________________________________
  515.  
  516.  BBS SOFTWARE: _____________________  Best Time to send
  517.                                       NetMail:_______ Node Number __________
  518.  BAUD RATE   : _____________________  [ ] Personal Use
  519.  MODEM       : _____________________  [ ] Commercial Use
  520.  
  521.  City/Country _______________________________________________
  522.  
  523.  
  524.  Where did you get your copy of NODE-DOOR?  _________________________________
  525.  
  526.  Comments or Suggestions for future versions:
  527.  
  528. _________________________________________________________________________
  529. _________________________________________________________________________
  530. _________________________________________________________________________
  531. _________________________________________________________________________
  532. _________________________________________________________________________
  533.  
  534.  Any questions or problems may be sent Via NetMail to 1:249/124
  535.  FidoNet
  536.  
  537. ======================================X cut here =======================
  538.  
  539.  
  540.  
  541.  
  542.  
  543.                              LEGAL STUFF
  544.  
  545.   We are not responsible for damage or loss of data due to unforeseen
  546.  defects or tampering.  This Software may be freely distributed in it's
  547.  original condition at no charge.  You may run multiple copies using the
  548.  same key code so long as the registered person owns those systems.
  549.  
  550.   You may run the unregistered version for a period of 30 days.  After
  551.  the evaluation period has lapsed you are obligated to either register
  552.  this software or remove it from your system. Compressed distribution
  553.  copies do not apply.
  554.  
  555.   NODE-DOOR is Copyright Don Laverdure, 1991/1992. ALL RIGHTS RESERVED.
  556.  You are granted permission to distribute the unaltered,unregistered
  557.  copy of this DOOR in it's origional Archive only.
  558.  
  559.   Don Laverdure, DRL BBS, DRL Registration Sites and Distribution sites
  560.  are not responsible for any loss of data caused by the use of
  561.  Unregistered or Altered versions of this software. Nor are the
  562.  afore mentioned parties responsible for any loss due to
  563.  miss-configuration or compatibility problems. Use at your own risk.
  564.  
  565.   NODE-DOOR and DRL Products have built in Virus detection for added
  566.  protection however there is no gurantee that a virus can be developed
  567.  that will be undetectable by NODE-DOOR or DRL Products.
  568.  
  569.   Future Versions may be made available to Registered users at no charge
  570.  for the Registration, however a small Handling charge may or may not
  571.  be required.
  572.  
  573. LIMITED WARRANTEE
  574.  
  575.   DRL-DOORS will provide a 30 day Money Back Gurantee.  If the door
  576.  fails to perform as a result of defects in programming (bugs). If
  577.  within 30 days of Registration, NODE-DOOR fails due to a problem
  578.  within the door itself.  Your registration will be cheerfully refunded
  579.  upon confirmation of the error or an Updated version will be made
  580.  available at no aditional charge.
  581.  
  582.  No warrantee is neither expressed nor implied on UNREGISTERED VERSIONS.
  583.  
  584.  
  585.  
  586.  
  587.                        Don Laverdure, FIDO NET 1:249/124
  588.         42 Leroy Grant Drive, Suite 407 Kingston, Ontario, Canada K7K 6W8
  589.                                 613-548-3691 BBS
  590.  
  591.  
  592.                                  ONLY $10.00 US
  593.  
  594.  
  595. NOTE:
  596.  
  597.               See changes.doc for new version changes
  598.  
  599.  
  600.  
  601.  
  602.